package com.example.ywr.service;

import com.example.ywr.common.PageParam;
import com.example.ywr.common.PageResult;
import com.example.ywr.entity.Category;

import java.util.List;

/**
 * 商品分类服务接口
 */
public interface CategoryService {

    /**
     * 添加分类
     *
     * @param category 分类信息
     * @return 添加后的分类信息
     */
    Category add(Category category);

    /**
     * 更新分类
     *
     * @param category 分类信息
     * @return 更新后的分类信息
     */
    Category update(Category category);

    /**
     * 根据ID删除分类
     *
     * @param id 分类ID
     * @return 是否删除成功
     */
    boolean delete(Long id);

    /**
     * 批量删除分类
     *
     * @param ids 分类ID列表
     * @return 是否删除成功
     */
    boolean batchDelete(List<Long> ids);

    /**
     * 根据ID获取分类详情
     *
     * @param id 分类ID
     * @return 分类详情
     */
    Category getById(Long id);

    /**
     * 分页查询分类列表
     *
     * @param pageParam 分页参数
     * @return 分类列表
     */
    PageResult<Category> list(PageParam pageParam);

    /**
     * 根据父分类ID查询子分类
     *
     * @param parentId 父分类ID
     * @return 子分类列表
     */
    List<Category> listByParentId(Long parentId);

    /**
     * 根据层级查询分类
     *
     * @param level 层级
     * @return 分类列表
     */
    List<Category> listByLevel(Integer level);

    /**
     * 根据名称模糊查询
     *
     * @param name      分类名称
     * @param pageParam 分页参数
     * @return 分类列表
     */
    PageResult<Category> listByName(String name, PageParam pageParam);

    /**
     * 更新分类状态
     *
     * @param id     分类ID
     * @param status 状态
     * @return 是否更新成功
     */
    boolean updateStatus(Long id, Integer status);

    /**
     * 批量更新分类状态
     *
     * @param ids    分类ID列表
     * @param status 状态
     * @return 是否更新成功
     */
    boolean batchUpdateStatus(List<Long> ids, Integer status);
}